edge-dev-agents

Complete agent-assisted development workflow for Edge repositories:
slash skills, companion scripts, coding standards, review standards,
and meta-tooling for maintaining the workflow itself.

The distributable Cursor content lives under .cursor/. This repo is the
versioned home for those skills, rules, scripts, and docs.

The canonical local doc lives at ~/.cursor/README.md. During
/convention-sync, that file is mirrored to edge-dev-agents/README.md, and
the repo copy should not keep a second .cursor/README.md.

Installation

1. Set the required env var in your ~/.zshrc:

export GIT_BRANCH_PREFIX=yourname   # e.g. jon, paul, sam

This drives branch naming and PR discovery across the workflow.

2. Sync the repo copy into ~/.cursor/:

This repo treats ~/.cursor/ as the canonical working copy. Use
/convention-sync to move local changes into edge-dev-agents, or run the
companion script directly when onboarding:

~/.cursor/skills/convention-sync/scripts/convention-sync.sh \
  --repo-to-user --stage

3. Verify prerequisites:

• gh CLI: gh auth login
• jq: brew install jq
• ASANA_TOKEN env var for Asana-backed workflows

Table of Contents

• Architecture
• Skills
• Companion Scripts
• Shared Modules
• Rules
• Design Principles

Architecture

edge-dev-agents/
├── README.md          # Synced copy of ~/.cursor/README.md
└── .cursor/
    ├── skills/        # Slash skills (*/SKILL.md) + companion scripts
    ├── scripts/       # Shared portability and dashboard scripts
    ├── commands/      # Minimal command wrappers
    └── rules/         # Coding and workflow standards (.mdc)

Separation of concerns:

• Skills (SKILL.md) define workflows, rules, and step ordering.
• Companion scripts (.sh, .js) handle deterministic work like git,
  GitHub, Asana, and JSON processing.
• Rules (.mdc) provide persistent guidance that gets loaded by context.
• Repo docs describe the system and how the distribution copy fits
  together.

All GitHub API work uses gh CLI. Deterministic git operations should live in
scripts, not be re-described independently across skills.

Skills (Slash Skills)

Core Implementation

Planning and Context

Review and Landing

Asana and Utility

Companion Scripts

PR Operations

PR Landing Pipeline (/pr-land)

Build, Lint, and Analysis

Asana and Portability

Shared Modules

Rules (.mdc files)

Design Principles

1. Scripts over duplicated reasoning. Deterministic git, API, and parsing
   work belongs in shared scripts.
2. gh over raw GitHub HTTP calls. Use the authenticated CLI for GitHub
   workflows.
3. Shared helpers over drift. Reusable mechanics like autosquash and push
   should live in one script and be consumed by multiple skills.
4. Rules before edits. Load the relevant standards before editing code or
   evaluating lint/type failures.
5. Workflow fixes before workarounds. If a skill is wrong, fix the skill or
   script instead of patching around it in an ad-hoc way.
6. Canonical local copy. ~/.cursor/ is the working source of truth;
   edge-dev-agents is the distribution and review copy.